home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1994 November / Cd Ware (Nro. 2) - Epimundo.iso / DOS / CM / DUP_BLOC.ZIP / DUP-BLOC.DOC < prev    next >
Encoding:
Text File  |  1994-05-13  |  20.8 KB  |  426 lines

  1.  *************************************************************************
  2.  *                            DUP-BLOC.PPE                               *
  3.  *                   A PCBoard 15 Sysop Utility PPE                      *
  4.  *                   version: 1.0    date: 5/9/1994                      *
  5.  *        (c) Copyright 1994  A. Segura/Fax~An~Ad Marketing, Inc.        *
  6.  *************************************************************************
  7.  
  8.  
  9. Purpose:        To improve your BBS SECURITY by performing a Caller-ID
  10.                 (CID) phone number check on the newuser against a file of
  11.                 existing user CallerID numbers to prevent the user from
  12.                 logging on under multiple/duplicate names/records. Used
  13.                 in conjunction with CALLBLOC.PPE ver. 2.5 (or greater) for
  14.                 callbloc's additional error-checking and recall capabilities.
  15.  
  16.  
  17. Features:       1. Extremely user (Sysop) configurable!
  18.                 2. Performs limited error and self-integrity checks!
  19.                 3. Sends messages to designated Sysop for detected callers!
  20.                 4. Allows security, language and graphics extension
  21.                    text display file!
  22.                 5. All display and message files are user editable!
  23.                 6. Can be placed in ANY directory!
  24.                 7. Built-in Defaults option for increased speed!
  25.                 8. Allows user-defined modem type!
  26.  
  27.                 And on, and on, and on........
  28.  
  29.  
  30.                         NOTE: Due to the extensive revision of CALLBLOC
  31.                               version 2.x, VULGARID version 1.x will not
  32.                               function properly with CALLBLOC 2.x. IF you
  33.                               are using or desire to use VULGARID, then
  34.                               you must install VULGARID version 2.x.
  35.  
  36.  
  37. Additional
  38. Requirements:   1. PCBoard version 15.x.
  39.                 2. Caller-ID capable modem (such as Supra or ZyXEL).
  40.                 3. Caller-ID service from local phone company.
  41.  
  42.                         NOTE: You do not need any other external
  43.                               Caller-ID box/device!!
  44.  
  45.  
  46. Zip File
  47. Contents:       1. DUP-BLOC      a sample duplicate caller text display file.
  48.                 2. DUP-BLOC.NUM  a sample phone number file.
  49.                 3. DUP-MSG       a sample bad call sysop message text file
  50.                 4. DUP-BLOC.CFG  the configuration file for DUP-BLOC.PPE
  51.                 5. DUP-BLOC.DOC  this file.
  52.                 6. DUP-BLOC.PPE  the subject PPE file.
  53.                 7. FILE_ID.DIZ   a brief BBS text description of this item.
  54.  
  55.  
  56.  
  57. Overview:       The remainder of this document is structured as follows:
  58.  
  59.                 1. Installation Usage -   describes how to install the PPE
  60.                                           in simple terms.
  61.                 2. CFG File Function -    describes the configuration file.
  62.                 3. PPE Execution -        describes how the PPE runs and
  63.                                           functions.
  64.                 4. CALLER log entries -   describes the various entries the
  65.                                           PPE will make to the PCB CALLER log.
  66.                 5. Support Files -        briefly describes the various text
  67.                                           display and associated support
  68.                                           files.
  69.                 6. Registration -         NONE!!  FREE!!
  70.                 7. Updates -              describes How/where to obtain
  71.                                           updates.
  72.                 8. Source code -          describes how to obtain the source
  73.                                           code.
  74.                 9. Distribution -         talks about it.
  75.                10. Disclaimer -           attorney said I had to have it.
  76.                11. Development History -  talks about it.
  77.                12. Other PPEs -           other PPEs I have available.
  78.  
  79.  
  80.  
  81. Installation
  82. Usage:          A. Determine the directory in which you desire to place
  83.                    the PPE and its support files.  They may be placed in
  84.                    any directory as long as all the files go there.  I
  85.                    suggest making a directory \PCB\PPE\DUP-BLOC and
  86.                    then just unzip DUP-BLOC.ZIP in the DUP-BLOC directory,
  87.                    but again, any directory will work.
  88.  
  89.                 B. Next, install the PPE in PCBTEXT record #123:
  90.  
  91.                       Step 1: Go to your \PCB directory and
  92.                               run program MKPCBTXT.EXE, at the
  93.                               file request prompt answer with
  94.                               the path/name to your PCBTEXT
  95.                               file (probably just enter
  96.                               PCBTEXT).
  97.  
  98.                       Step 2: MKPCBTXT display screen should
  99.                               now appear, Depress F3 key.
  100.  
  101.                       Step 3: Answer the prompt with: 123
  102.  
  103.                       Step 4: The text prompt display will
  104.                               now appear.
  105.  
  106.                               NOW, edit the field with the
  107.                               path/name of the PPE, such as:
  108.                               !C:\PCB\PPE\DUP-BLOC\DUP-BLOC.PPE.
  109.                               Don't forget the ! character, it
  110.                               is mandatory to cause PCBoard to
  111.                               recognize and execute a PPE.
  112.  
  113.                       Step 5: Now just save and exit MKPCBTXT.
  114.  
  115.                       Step 6: Next and Last, go to the direc-
  116.                               tory containing the DUP-BLOC files
  117.                               and edit the configuration file
  118.                               (DUP-BLOC.CFG) to your desire,
  119.                               see the CFG file description
  120.                               below for info.  Also, you may
  121.                               edit the other text display files
  122.                               as you desire.
  123.  
  124.  
  125.                 C. If your PCBoard modem initialization string does not
  126.                    already have CallerID function turned-on, then that
  127.                    must be done also.
  128.  
  129.                    The PPE obtains the Caller-ID info directly from PCBoard
  130.                    software, not the modem itself, so, PCBoard software must
  131.                    be set to answer on the 2nd ring and the modem CallerID
  132.                    enable command must be placed in the PCBoard modem
  133.                    Initialization string or similar setup. (i.e. if PCBoard
  134.                    is writing the CallerID info in your CALLER log, then
  135.                    the setup is OK, if it isn't, then you must get PCBoard
  136.                    and CallerID working first).
  137.  
  138.                     NOTES: a. for Supra modems, add the #CID=1 command to
  139.                               the modem init string.  Also, some sysops
  140.                               have reported having to set S110=3 to get
  141.                               14400baud connections. (To perform this, run
  142.                               PCBSETUP, at Main Menu, select Modem Informa-
  143.                               tion, Modem Setup, Modem Initialization String).
  144.  
  145.                            b. To set answer on 2nd ring, run PCBSETUP, at
  146.                               Main Menu, select Modem Information, Config-
  147.                               uration Switches, Number of Rings Required: 2.
  148.  
  149.                            c. To enable PCBoard writing of CID info to
  150.                               CALLER log, run PCBSETUP, at Main Menu, select
  151.                               Configuration Options, Logging Options, Log
  152.                               Connect String to Disk: Y.
  153.  
  154.  
  155.  
  156. CFG File Function:      The DUP-BLOC.CFG file provides the Sysop with the
  157.                         capability to customize and select options for
  158.                         DUP-BLOC.PPE to perform.  Below is a sample of
  159.                         the configuration file and the entry descriptions:
  160.  
  161.               CFG file                        Built-in Defaults
  162.           ----------------------------    -------------------------------
  163.  
  164. Line 1    1                               1
  165. Line 2    SYSOP                           SYSOP
  166. Line 3    10                              10
  167. Line 4    1                               1
  168. Line 5    0                               1
  169.  
  170.           ----------------------------    -------------------------------
  171.  
  172.  
  173.     Line 1: String indicating modem type (1, 2 or prefix string)  1=Supra or
  174.             Practical Peripherals modem, 2=ZyXEL modem, or the phone
  175.             number actual prefix string for other modem types.
  176.  
  177.                 For example, Supra CID string is as follows:
  178.  
  179.                    CID: DATE = 0108 TIME = 0630 NMBR = 7034509456
  180.  
  181.                 Therefore, the Supra modem prefix is "NMBR = ".  However,
  182.                 the PPE knows this if you just enter a "1".  But this
  183.                 example is provided for those that have a different CID
  184.                 string.  The CID string can be seen in the PCB CALLER log.
  185.  
  186.     Line 2: Addressee (Sysop or Co-Sysop) for Dup call alert message.
  187.  
  188.     Line 3: The number of digits in your local CallerID service, usually
  189.             10, but someplaces 7 digits.
  190.  
  191.     Line 4: The security level to downgrade the offending user to.
  192.  
  193.     Line 5: Flag to indicate whether to allow automatic updating of
  194.             DUP-BLOC.NUM file with number of every newuser to prevent
  195.             future duplicate logons. (1= enable automatic update, 0= Sysop
  196.             must make manual entries).
  197.  
  198.         If you desire a faster execution (no disk read access slowdown),
  199.         you can activate the built-in defaults simply by either deleting
  200.         the DUP-BLOC.CFG file or renaming it to something else, i.e.
  201.         READ.CFG.
  202.  
  203.  
  204.                 NOTE: You must review and edit the CFG file for
  205.                       your system and desires.
  206.  
  207.  
  208.  
  209. PPE Execution:  1. The DUP-BLOC.PPE starts execution by displaying
  210.                    the text display message "... Searching Phone
  211.                    Records ...".  However, if the DUP-BLOC.NUM file is
  212.                    missing, instead of the previous message, a message
  213.                    "...TELL SYSOP DUP-BLOC.NUM file is missing!" is
  214.                    displayed and the PPE terminates, returning to normal
  215.                    PCBoard user login function.
  216.  
  217.                 2. Next, the PPE performs a simple self-check of DUP-BLOC.NUM
  218.                    file to make certain it is a valid file.  If the check
  219.                    passes, the text message "..CallerID file integrity
  220.                    passed..." is displayed on the local BBS display only.
  221.                    The check is fairly simple, the first record (entry)
  222.                    in the file must be '1234567890'.  So, you must always
  223.                    leave the first line that way.  This is just an extra
  224.                    measure to make sure there are no accidental lock-outs
  225.                    due to a corrupted file.
  226.  
  227.                    If the check fails, a text message "CallerID file
  228.                    integrity FAILED!" is displayed on the local BBS screen,
  229.                    an alarm is sounded at the BBS PC speaker, and the PPE
  230.                    terminates and returns to the normal user login.
  231.  
  232.                 3. When the PPE detects a match, an entry is made in the PCB
  233.                    CALLER log file and a message is sent to the Sysop and the
  234.                    user is downgraded to the configured level.
  235.  
  236.                 4. When the PPE completes, the message "DUP-BLOC Successfully
  237.                    Completed!" is displayed on the local screen only.
  238.  
  239.  
  240.  
  241. CALLER log entries:  Listed below are examples of entries that DUP-BLOC
  242.                      can make to the PCB CALLER log:
  243.  
  244.                         1. 'No CALLERID info available! (DUP-BLOC.PPE)' -
  245.                             indicates CID data was not read for some
  246.                             reason, perhaps a poor phone line connection
  247.                             or CID command not active for modem or a
  248.                             non-CID capable modem.
  249.  
  250.                         2. 'DUP-BLOC.PPE using built-in defaults' - the
  251.                            DUP-BLOC.CFG file does not exist so PPE has
  252.                            switched to built-in defaults.
  253.  
  254.                         3. 'Verify proper CID Key for your modem!
  255.                            (DUP-BLOC.PPE)' - CID prefix key selected is
  256.                            not correct or very bad phone line.
  257.  
  258.                         4. 'Can't find file DUP-BLOC.NUM! (DUP-BLOC.PPE)'
  259.  
  260.                         5. 'CallerID file integrity FAILED! (DUP-BLOC.PPE)' -
  261.                            The first line entry in file DUP-BLOC.NUM is bad.
  262.  
  263.                         6. 'DUP-BOY called again! Check Log..(DUP-BLOC.PPE) -
  264.                            indicates a match was found.
  265.  
  266.  
  267. Support Files:
  268.  
  269.         1.      You must create two files (samples already made in the zip).
  270.                 One file named 'DUP-BLOC.NUM' which contains the known bad
  271.                 phone numbers to block, one number per line, followed by a
  272.                 remark line.  The number line format is '2024307269' (only
  273.                 the actual number!--or, whatever the format of your caller-id
  274.                 service number string).  See the example file, it is fairly
  275.                 simple.  The first entry in the file is an integrity check,
  276.                 as described in PPE Execution, paragraph #2 above, so do not
  277.                 edit this line.  Make sure there are NO blank lines, includ-
  278.                 ing a last line, in the file.
  279.  
  280.                 The second file is called 'DUP-BLOC' (again, an example
  281.                 file is provided).  This file is the text display file to be
  282.                 shown to the offender.  Obviously, it can be edited to your
  283.                 preference.  PCB text file extensions for Language, Security
  284.                 and Graphics are recognized.
  285.  
  286.         2.      DUP-MSG is the text incorporated into the message to the
  287.                 Sysop when a bad caller match is detected.  Edit it as
  288.                 desired.
  289.  
  290.  
  291.  
  292. Registration:   NONE!!  There is no registration fee.  Basic use of the PPE
  293.                 is FREE!!!
  294.  
  295.                 However, if you feel compelled that my work is worth
  296.                 compensation, I will accept all offers.  Thank You!
  297.  
  298.                 Also, if you would like to provide suggestions for
  299.                 improvement to the PPE, bug reports, or just a note
  300.                 of thanks or hello, please forward those as well.  See
  301.                 below for my mailing address and BBS number. Additionally,
  302.                 I frequently browse the RIME Sysop and PCBoard conferences,
  303.                 although contacting me there is not as reliable because
  304.                 sometimes I get too busy to call.
  305.  
  306.  
  307. Updates:        The latest version of the PPE program can be obtained from
  308.                 my BBS: SBG Online! BBS (703) 450-9456.  If you have any
  309.                 comments or suggestions for improvement, you can leave them
  310.                 there also.  The file will be found in directory #1 as a
  311.                 FREE/NOTIME file.  The BBS runs PCBoard 15 at 14400v42bis.
  312.  
  313.  
  314. Source          If you desire a diskette containing the PPL source code so
  315. Code:           you can modify it for your own use, the cost is $15 US.  I
  316.                 accept cash, money order, VISA or Mastercard. You can place
  317.                 an order online on the BBS (703) 450-9456 or by mail at:
  318.                 A. Segura, P.O. Box 1089, Sterling, VA, 20167-1089.
  319.  
  320.                 EXTRA, EXTRA!! In addition to the DUP-BLOC source, you
  321.                 will also receive source to a "Last TEN Caller" and
  322.                 "Running Log Caller" bulletin generators that I have
  323.                 developed as well.
  324.  
  325.                 As another option, for $25, you can subscribe to the PPE
  326.                 conference on my BBS.  The conference will always contain
  327.                 the latest version of the source code for CALLBLOC, DUP-BLOC,
  328.                 CALLERID, VULGARID and several other PPEs for immediate
  329.                 downloading.  The subscription period lasts one year.  We
  330.                 also have the latest version of the PIER Shareware CDROM
  331.                 always online.  You can even subscribe online with your
  332.                 VISA/MC via (S)cript Questionaire #2 for immediate access.
  333.  
  334.  
  335. Distribution:   You may freely distribute this complete package only in an
  336.                 unmodified form.  No remuneration may be collected or charged
  337.                 for this work by anyone other than the below noticed
  338.                 individual/company except for that cost incurred in actual
  339.                 electronic media production (i.e. diskette or CDROM).  In
  340.                 other words, it can be placed on BBSs, shareware CDROMS, etc.
  341.                 but I/my company reserves the right of copyright and
  342.                 remuneration for the actual work.  The source code MAY NOT
  343.                 be distributed by anyone other than the below listed company.
  344.  
  345.  
  346. Disclaimer:     The user agrees when utilizing this package that he does so
  347.                 at his own risk with no guarantees, implied or otherwise, as
  348.                 to the functional performance or liability of the package.
  349.  
  350.  
  351. Development
  352. History:        ver.   date       remarks
  353.                 ----   --------   ---------------------------------------
  354.                 1.0    05/09/94   Initial release.
  355.  
  356.  
  357. ***************************************************************************
  358. *        (c) Copyright 1993  A. Segura/Fax~An~Ad Marketing, Inc.          *
  359. ***************************************************************************
  360.  
  361.  
  362. Other PPEs:
  363.  
  364.  ********************************************************************
  365.  *      Look for these other fine utilities at a BBS near you       *
  366.  ********************************************************************
  367.  
  368.  AUTOSUBS.PPE   run as a script questionnaire, allows online credit
  369.                 card subscriptions to BBS (VISA/MC), completes log
  370.                 entries and sends alert message to SysOp. (for
  371.                 PCBoard 15)
  372.  
  373.  ALLCALL.PPE    generates a text display bulletin, complete with PCB
  374.                 color codes, of all the callers to the board.
  375.  
  376.  ALLSTAT.PPE    generates a text display bulletin, complete with PCB
  377.                 color codes, of statistics of all the callers to the board.
  378.  
  379.  BULLCHK.PPE    performs automated tracking of bulletins read by the
  380.                 user and performs a user upgrade when all sysop selected
  381.                 bulletins have been read.
  382.  
  383.  CALLERID.PPE   performs basic callerid identification, logs info
  384.                 in file log and user records if desired, and will
  385.                 also display desired text screens to users--must
  386.                 have callerid capable modem.  Several SysOp config-
  387.                 uable options. (for PCBoard 15)
  388.  
  389.  CALLBLOC.PPE   performs a call blocking function before the
  390.                 user can log on based upon a SysOp defined listing
  391.                 of undesirable phone numbers--must have callerid
  392.                 capable modem. Even sends the SysOp an alert message.
  393.                 (for PCBoard 15)
  394.  
  395.  DUP-BLOC.PPE   Blocks current users from signing-on with duplicate
  396.                 records--uses CallerID info.  Should be used with
  397.                 CALLBLOC.PPE for complete blocking system.
  398.  
  399.  MAKEBLTN.EXE   Top callers, cities, down/uploaders bulletin generator
  400.  
  401.  PADLOADS.EXE   Automated uploads directory padder--makes your BBS look
  402.                 more active with more daily uploads.
  403.  
  404.  REPORT.EXE     Program generates reports of CallerID info, user record
  405.                 phone numbers, common passwords and several other goodies
  406.                 to aid Sysop in identifying abusive or questionable users.
  407.  
  408.  VULGAR.PPE     performs a vulgar word/phrase check on user names and
  409.                 city entries based on a file of names defined by
  410.                 SysOp, and performed before complete newuser login.
  411.                 (for PCBoard 15)
  412.  
  413.  VULGARID.PPE   same program as VULGAR.PPE except it automatically
  414.                 passes the callerid info to CALLBLOC.PPE program
  415.                 for future lock-outs. (must have both programs and a
  416.                 modem that supports callerid) (for PCBoard 15)
  417.  
  418.                 NOTE: VULGARID ver. 1.x only works with CALLBLOC
  419.                       ver. 1.x.  VULGARID ver. 2.x only works
  420.                       with CALLBLOC ver. 2.x.
  421.  
  422. ***************************************************************************
  423. *        (c) Copyright 1993  A. Segura/Fax~An~Ad Marketing, Inc.          *
  424. ***************************************************************************
  425.  
  426.